Начало работы

Чтобы начать работать с Яндекс Такси:

1. Получите токен для отправки запросов к API.

   1. Войдите в Кабинет Корпоративного Клиента Яндекс Такси с помощью выданного вам логина и пароля.
   2. Перейдите во вкладку Профиль компании.
   3. Нажмите на кнопку Получить токен.
   4. На странице oauth.yandex.ru нажмите кнопку Войти как <ваш логин>. Вы будете перенаправлены в Кабинет Корпоративного Клиента Яндекс Такси.
   5. В блоке Токен сгенерирован будет отображен ваш OAuth-токен.

2. Токены для доступа к API действуют ограниченное время, после которого становятся недействительными. Используйте запрос Обновить OAuth-токен чтобы получить время жизни вашего токена.

   • Если время жизни токена подходит к концу — повторно выполните запрос Обновить OAuth-токен. Дата устаревания вашего токена будет обновлена и вы сможете продолжать пользоваться текущим токеном.
   • Если время жизни токена истекло — получите новый токен в Кабинете Корпоративного Клиента Яндекс Такси.

   Примечание

   Если токен утерян, для перевыпуска обратитесь в Яндекс Паспорт.

3. Используйте OAuth-токен во всех запросах к API. Передавайте токен в заголовке:

   • в версии API 1.0: Authorization: <значение вашего токена>
   • в версии API 2.0: Authorization: Bearer <значение вашего токена>

   Примечание

   Для работы с API 1.0 используйте хост https://business.taxi.yandex.ru, а для работы с API 2.0 — хост http://b2b-api.go.yandex.ru.

4. Для большинства запросов необходимо указывать идентификатор клиента (client_id). Получить значение можно при помощи запроса Информация о клиенте.

5. Укажите информацию о кост-центрах.

6. Создайте роли пользователей.

7. Заведите учетные записи пользователей:

   • в версии API 1.0: создание пользователя
   • в версии API 2.0: создание пользователя

Заказ поездки

После того, как вы получили токен и указали информацию о ваших пользователях, вы можете использовать API Яндекс Такси для заказа поездок.

Процедура заказа выглядит следующим образом:

1. Узнайте цену и условия предстоящей поездки и получите оффер.
2. Создайте черновик заказа.
3. Передайте заказ на обработку.
4. При необходимости отмените заказ.